home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / general / procssng / compstol / read.me < prev    next >
Text File  |  1991-07-23  |  6KB  |  167 lines
  1. README 5/08/90
  2. Composite Tool
  3.  
  4. _______________________________________________________________________________
  5. BEFORE YOU BEGIN
  6.  
  7. Please read the README.FIRST file - found at the root level of this server - 
  8. for general information and instructions on unarchiving and uncompressing
  9. files (files with the ".sit", ".hqx", ".zip", ".tar", and ".Z" extensions).
  10.  
  11. The README.BROCHURE also contains helpful descriptions of this and other
  12. software offered on the ftp server.
  13.  
  14. _______________________________________________________________________________
  15. COMPOSITE TOOL
  16.  
  17. This README is in the anonymous ftp directory for Version 1.1 of CompositeTool 
  18. for the Sun Workstation.
  19.  
  20. _______________________________________________________________________________
  21. NEW FEATURES
  22.  
  23. 1. Support for the full line of Sun Architectures. This includes
  24.    the Sun-3, Sun-4, and Sun386i.
  25. 2. Support ONLY for SunOS 4.x. Please let us know if 3.x support on
  26.    the Sun-3 is critical. CompositeTool 1.1 has NOT been tested under
  27.    SunOS 3.x. We guarantee that it will not work completely
  28.    reliably under 3.x because of changes in the OS!
  29. 3. Is upward compatiable with CompositeTool 1.0. All the features
  30.    that worked under 1.0 should work under 1.1.
  31. 4. Includes full NCSA HDF (Hierarchical Data Format) support. The
  32.    HDF routines are included as part of the distribution.
  33. 5. There are no embedded parameters in the source distribution. They
  34.    are now handled through Sun User Defaults database mechanism.
  35. 6. A number of cosmetic changes have been made. In particular,
  36.    panel fonts are selected from the user defaults database so that
  37.    one can now run CompositeTool in a SunView Environment with
  38.    different fonts outside of CompositeTool. You still don't have
  39.    control over the font of the frame labels because that remains a
  40.    limitation of SunView.
  41. 7. Great care has been made to simplify the installation.  There is
  42.    one Makefile with two targets: personal and system. Run personal
  43.    to produce a working local version first and then run system as
  44.    root for the system wide version once you are satisified that the
  45.    local version works out. READ THE MAKEFILE BEFORE DOING ANYTHING!
  46.    It will save you some grief especially on the Sun-4. The
  47.    instructions are relatively painless. Please do not be intimidated
  48.    by the actual details of the script.
  49. 8. The Read_Defaults_Database false problem has been solved so as
  50.    long as the CompositeTool master database has been installed
  51.    a user need never have to worry about the state of her private
  52.    database when trying to use CompositeTool at anytime.
  53. 9. When reading program settings from a file any file which does
  54.    not exist is searched for in the directory of the settings file
  55.    as a last resort. One now has the ability to move a composite
  56.    around as a directory of files and not be tied to only absolute
  57.    pathnames.
  58. 11. On Sun systems with a monochrome overlay plane the startup logo
  59.     will only flash at best unless you run SunView with the
  60.     -8bit_color_only option. 
  61. 12. Testing:
  62.     Sun-3/160, Sun-3/110    SunOS 4.0.3 
  63.     Sun386i/250        SunOS 4.0.1
  64.     Sun-4/150        SunOS 4.0.3
  65. 13. Claim:
  66.     Should work fine on the new SparcStations and the new 
  67.     68030 based workstations without change. Let us know
  68.     if it does or does not!
  69.  
  70. _______________________________________________________________________________
  71. INSTALLATION NOTES
  72.  
  73. File: CompositeTool1.1.src.tar.Z
  74. Contents:
  75.  
  76. ./v1.1.dist        - Distribution directory with contents listed below.
  77.  
  78. CompositeTool.d        - Master Defaults Database file for CompositeTool. This
  79.               is modified during system installation and copied
  80.               to the directory /usr/lib/defaults.
  81. HDF/            - NCSA HDF (Hierarchical Data Format) directory
  82.               containing all the source and makefile to create
  83.               the libdf.a library. 
  84. Makefile        - Makefile for installing CompositeTool.
  85. compositetool.c        - Source of CompositeTool 1.1.
  86. samples/        - Directory of 6 sample composites, one per directory. 
  87.     demo.null/    - Settings file is file demo.null
  88.     demo.session.a/ - Settings file is file demo.session.a
  89.     demo.session.b/ - Settings file is file demo.session.b
  90.     demo.session.c/ - Settings file is file demo.session.c
  91.     logos/        - Settings file is file logos
  92.     sinx_siny/    - Settings file is file sinx_siny
  93. logo.hdf        - 308x219 logo image and palette in HDF format.
  94. pal_initial.raw        - Initial 256-color raw palette loaded after the
  95.               logo with its palette are displayed on startup.
  96.  
  97.  
  98. 1. Put copy of  CompositeTool1.1.tar.Z  in your current directory.
  99. 2. Space required in this directory to continue:
  100.  
  101.     2.1 Extracted files from compressed tar file
  102.         ~ 1.2 MB
  103.     2.2 Personal installation - additional
  104.         ~ .6 MB        Sun-3
  105.         ~ .6 MB        Sun386i
  106.         ~ .6 MB        Sun-4
  107.         Some of this is recovered because the compositetool.o
  108.         is removed.
  109.     2.3 System installation - no space is used in this
  110.         directory unless you so designate it in the Makefile.
  111.  
  112.     PLEASE NOTE THAT TEMPORARY SPACE IS REQUIRED TO DO EITHER
  113.     INSTALLATION. Consult the Makefile in the distribution for
  114.     approximate sizes.
  115.  
  116. 3. Execute:
  117.  
  118.     zcat CompositeTool1.1.tar.Z | tar xvfB - 
  119.  
  120.    to extract the directory    ./v1.1.dist
  121.    and place it in your current directory.
  122.  
  123. 4. Execute:
  124.  
  125.     cd v1.1.dist
  126.  
  127.    and read the documentation in the Makefile carefully.
  128.  
  129. 5. For a personal installation:
  130.  
  131.     5.1 Change any required macros (only one at most) in the
  132.         Makefile.
  133.     5.2 Execute:
  134.  
  135.         make personal
  136.  
  137.         . . . messages . . .
  138.             
  139.          The executable, compositetool, is now ready to execute
  140.          in SunView IN THIS DIRECTORY! If you move out of this
  141.          directory you will have to change some personal defaults
  142.          by either editing $HOME/.defaults or executing
  143.  
  144.         defaultsedit
  145.  
  146.          in SunView and changing them.
  147.  
  148. 6. For a system installation:
  149.  
  150.     6.1 Change any required macros (only at most three) in the
  151.         Makefile.
  152.     6.2 Become superuser by executing:
  153.  
  154.         su root
  155.         password: <fill in>
  156.  
  157.     6.3 Execute:
  158.  
  159.         make system
  160.  
  161.         . . . messages . . .
  162.  
  163.     6.4 Add the system directory where compositetool and
  164.         associated files were installed to your search path
  165.         by editing either your .login/.cshrc file or .profile
  166.         file.
  167.